클로드 코드 완벽 가이드 — 5장 슬래시 명령어 제대로 알아보기 딥다이브 학습 노트

출처: 클로드 코드 완벽 가이드 (코드팩토리 최지호) | 참고: https://github.com/codefactory-co

5장에서 다루는 내용

• /model 명령어 — 모델 선택과 비용 최적화 (Default 옵션의 자동 전환 메커니즘)
• /compact 명령어 — 콘텍스트 윈도우 관리와 Auto Compact
• /config 명령어 — 클로드 코드 전반적인 설정 변경 (7가지 설정 항목)
• /permissions 명령어 — 자동 실행 권한 관리 (Allow/Deny/Workspace)
• /memory 명령어 — CLAUDE.md 기반 메모리 관리 (프로젝트/사용자 단위)
• /mcp 명령어 — MCP 서버 연동 및 관리

전체 흐름도

[/model]              [/compact]            [/config]
 모델 선택              콘텍스트 정리          전반 설정
    |                      |                     |
    v                      v                     v
+------------------+  +------------------+  +------------------+
| Default(권장)    |  | 수동 /compact    |  | Auto-compact     |
|  Opus → Sonnet   |  |  직접 실행 추천   |  | Use todo list    |
|  자동 전환       |  |                  |  | Verbose output   |
|                  |  | Auto Compact    |  | Theme            |
| Opus: 고성능     |  |  200K 꽉 차면    |  | Notifications    |
| Sonnet: 일상용   |  |  자동 실행       |  | Editor mode      |
+------------------+  +------------------+  | Model            |
                                            +------------------+

[/permissions]        [/memory]             [/mcp]
 자동 실행 권한         메모리 관리            MCP 서버 관리
    |                      |                     |
    v                      v                     v
+------------------+  +------------------+  +------------------+
| Allow / Deny     |  | ./CLAUDE.md      |  | MCP 서버 조회    |
| Workspace        |  |  프로젝트 단위   |  | 도구 목록 확인   |
|                  |  |                  |  | 명령어 실행      |
| 프로젝트 단위    |  | ~/.claude/       |  |                  |
|  .claude/        |  |  CLAUDE.md       |  | e.g. 토스페이먼츠|
|  settings.       |  |  사용자 단위     |  |  integration     |
|  local.json      |  |                  |  |  guide           |
| 사용자 단위      |  |                  |  |                  |
|  ~/.claude/      |  |                  |  |                  |
|  settings.json   |  |                  |  |                  |
+------------------+  +------------------+  +------------------+

선수 지식 체크리스트

• [ ] 클로드 코드 기본 설치 및 실행 방법 (터미널 기반)
• [ ] 슬래시 명령어의 기본 개념 (/ + 명령어 입력)
• [ ] Max 플랜 요금제 개념 ($100/$200 플랜 차이)
• [ ] 콘텍스트 윈도우의 개념 (AI가 기억할 수 있는 범위)

핵심 키워드

섹션 1: 모델을 설정하는 가장 중요한 명령어, /model

한 줄 요약

/model 명령어로 Opus/Sonnet/Default 중 모델을 선택하며, Default 옵션은 비용을 자동으로 최적화해준다.

쉬운 설명 (핸드폰 요금제 비유)

"핸드폰 요금제에서 '데이터 무제한'을 쓰다가 일정량을 넘으면 속도가 줄어드는 것과 같다. Default 옵션은 처음엔 고성능 Opus를 쓰다가 사용량이 많아지면 자동으로 Sonnet으로 전환해서 비용을 절약해준다."

실무 예제: /model 사용하기

> /model              ← 터미널에 입력

Select Model
1. Default (recommended)  Opus 4 → 50% 이상이면 Sonnet 4로 전환
2. Opus                   복잡한 작업용 (토큰 ~5배 빠르게 소진)
3. Sonnet                 일상 작업용

> /model
└ Set model to opus (claude-opus-4-20250514)

Default 옵션의 자동 전환 규칙

$100 플랜:
  처음 → Opus 모델 사용
  사용 제한의 20% 이상 → 자동으로 Sonnet 전환

$200 플랜:
  처음 → Opus 모델 사용
  사용 제한의 50% 이상 → 자동으로 Sonnet 전환

❌ Opus를 강제 선택 → 토큰을 빠르게 소진 → 5시간 동안 작업 불가
✅ Default 선택 → 자동 전환으로 비용 절약 → 안정적 사용

핵심 체크포인트

• ✅ /model 명령어는 클로드 코드에서 가장 중요한 슬래시 명령어
• ✅ Default 옵션은 Opus → Sonnet 자동 전환으로 비용 최적화
• ✅ 습관적으로 /model을 입력해서 현재 모델을 확인하는 것이 좋다
• ✅ Opus 강제 선택 시 토큰 소진으로 5시간 작업 중단 위험

섹션 2: 콘텍스트를 정리하는, /compact

한 줄 요약

/compact는 대화가 길어져 콘텍스트 윈도우가 가득 찰 때 중요한 내용만 요약하여 정리해주는 명령어다.

쉬운 설명 (책상 정리 비유)

"책상 위에 책이 쌓여서 더 이상 올려놓을 공간이 없을 때, 덜 중요한 책은 서랍에 넣고 핵심 노트만 남기는 것과 같다. /compact는 대화 내용 중 중요한 것만 남기고 나머지를 정리한다."

실무 예제: /compact 사용 시점

상황: 클로드 코드와 오랜 대화 후 콘텍스트 윈도우 200K가 거의 참

❌ 그냥 계속 대화 → 더 이상 새로운 정보를 받아들이지 못함
✅ /compact 실행 → 중요한 내용만 콘텍스트에 남김

Auto Compact vs 수동 /compact:
┌──────────────────┬───────────────────────────┐
│ Auto Compact     │ 200K 콘텍스트가 꽉 차면   │
│                  │ 자동으로 /compact 실행     │
├──────────────────┼───────────────────────────┤
│ 수동 /compact    │ 작업 전환점에서 직접 실행  │
│  (저자 추천)     │ 의도치 않은 요약 방지      │
└──────────────────┴───────────────────────────┘

왜 수동 /compact를 추천하나?

Auto Compact의 문제점:
  작업 도중에 자동 실행 → 콘텍스트 요약이 어색해질 수 있음
  마치 책의 1장을 요약하지 않고 1.5장을 요약하는 것과 같은 이치

저자 추천:
  "다음 요청이 현재까지의 내용과 현저히 다르거나,
   중요한 내용이 잘 기억되면 좋을 것 같을 때
   직접 /compact 명령어를 실행하는 걸 추천합니다."

핵심 체크포인트

• ✅ /compact는 200K 콘텍스트 윈도우를 관리하는 핵심 명령어
• ✅ Auto Compact보다 수동 /compact 실행이 더 안정적
• ✅ 작업 전환점(주제가 바뀔 때)에서 실행하는 것이 가장 효과적
• ✅ Ctrl+R로 요약된 내용을 확인할 수 있음

섹션 3: 클로드 코드 전반적인 설정 변경, /config

한 줄 요약

/config는 Auto-compact, 테마, 에디터 모드 등 클로드 코드의 전반적인 설정을 변경하는 명령어다.

쉬운 설명 (스마트폰 설정 앱 비유)

"스마트폰에서 '설정' 앱을 열면 밝기, 알림, 배경화면 등을 바꿀 수 있는 것처럼, /config는 클로드 코드의 모든 환경을 입맛대로 조절할 수 있는 설정 화면이다."

/config 설정 항목 7가지

Settings
Configure Claude Code preferences

> Auto-compact      true      ← 콘텍스트 꽉 차면 자동 /compact
  Use todo list     true      ← 긴 작업 시 Todo 리스트 표시
  Verbose output    false     ← 출력 결과를 길게 보여줄지
  Theme             Dark mode ← 테마 선택
  Notifications     terminal_bell ← 작업 완료 알림 방식
  Editor mode       normal    ← normal / vim 모드 선택
  Model             opus      ← 사용할 모델

저자의 추천 설정

┌────────────────────┬──────────┬────────────────────────────────────┐
│ 설정               │ 추천값   │ 이유                               │
├────────────────────┼──────────┼────────────────────────────────────┤
│ Auto-compact       │ true     │ 직접 /compact를 실행하는 게 최선   │
│                    │          │ 이지만, 혹시 못하더라도 자동 실행   │
├────────────────────┼──────────┼────────────────────────────────────┤
│ Use todo list      │ true     │ 끌 이유가 없음. Todo list로 목표   │
│                    │          │ 지향적 작업 가능                   │
├────────────────────┼──────────┼────────────────────────────────────┤
│ Verbose output     │ false    │ 먼저 false로 사용하다 부족하면     │
│                    │          │ true로 변경                        │
├────────────────────┼──────────┼────────────────────────────────────┤
│ Theme              │ Dark mode│ (저자 취향)                        │
├────────────────────┼──────────┼────────────────────────────────────┤
│ Notifications      │ terminal │ Kitty 등 터미널에서 terminal_bell  │
│                    │ _bell    │ 이 가장 무난                       │
├────────────────────┼──────────┼────────────────────────────────────┤
│ Editor Mode        │ normal   │ Vim을 모르면 normal 권장            │
│                    │          │ (Vim 난이도 높음)                  │
├────────────────────┼──────────┼────────────────────────────────────┤
│ Model              │ Opus     │ $200 플랜이면 Opus 추천. 저렴한    │
│                    │          │ 플랜이면 Sonnet 기본 설정 권장      │
└────────────────────┴──────────┴────────────────────────────────────┘

핵심 체크포인트

• ✅ /config로 7가지 설정을 한 곳에서 관리
• ✅ 기본 설정으로도 충분히 클로드 코드의 모든 성능을 누릴 수 있음
• ✅ vim 모드는 Vim 사용자에게 유용하지만 초보자에겐 normal 모드 권장
• ✅ 설정이 어렵다면 기본값 그대로 사용해도 무방

섹션 4: 자동 실행에 대한 권한 설정, /permissions

한 줄 요약

/permissions는 클로드 코드가 파일 생성/삭제 등의 작업을 허락 없이 자동 실행할 수 있도록 권한을 관리하는 명령어다.

쉬운 설명 (스마트폰 앱 권한 비유)

"스마트폰에서 카메라 앱이 사진첩 접근 권한을 요청하는 것처럼, 클로드 코드도 파일을 만들거나 삭제할 때 허가를 받는다. /permissions는 이 허가를 미리 등록해두는 명령어다."

실무 예제: 권한 설정하기

> /permissions

Permissions: [Allow]  Deny  Workspace

1. Add a new rule...

예: ls 명령어를 자동 허가하려면
  → Bash(ls:*) 입력
  → "Where should this rule be saved?" 선택:
    1. Project settings (local)  → .claude/settings.local.json
    2. Project settings          → .claude/settings.json (체크인됨)
    3. User settings             → ~/.claude/settings.json

❌ 권한 허가 없이 매번 수동 승인 → 반복 작업마다 허가 요청 → 비효율
✅ 자주 쓰는 도구를 /permissions에 등록 → 자동 실행 → 효율 극대화

권한 설정의 안전성

"클로드 코드가 마음대로 모든 수정을 할 수 있도록 한다면
 중요한 파일을 삭제하거나 잘못 수정할 수 있지 않나?"

→ 저자의 답: "클로드 코드를 많이 사용하다 보면
  '크게 상관없다'는 결론에 도달하게 됩니다."

이유:
  • 다양한 테스트로 파괴적인 변화를 최대한 억제
  • 자주 커밋하면 문제 발생 시 되돌리기 가능
  • 하나하나 허가하는 것보다 빠르게 작업 가능

핵심 체크포인트

• ✅ Allow/Deny/Workspace 3가지 옵션으로 권한 관리
• ✅ 프로젝트 단위(.claude/settings.local.json)와 사용자 단위(~/.claude/settings.json) 분리
• ✅ 자주 커밋하면 권한을 넓게 줘도 안전하게 되돌릴 수 있다
• ✅ auto-accept edits 옵션으로 코드 수정 자동 승인 가능

섹션 5: 클로드 코드의 메모리 관리, /memory

한 줄 요약

/memory는 CLAUDE.md 파일을 통해 프로젝트 단위 또는 사용자 단위로 클로드 코드의 메모리를 관리하는 명령어다.

쉬운 설명 (포스트잇 비유)

"프로젝트 폴더 앞에 포스트잇을 붙여놓으면 매번 그 폴더를 열 때 '아, 이 프로젝트는 이런 규칙이 있지'라고 기억하는 것과 같다. CLAUDE.md 파일이 바로 그 포스트잇 역할이다."

실무 예제: /memory 사용하기

> /memory

Select memory to edit:
  1. Project memory    Saved in ./CLAUDE.md
  2. User memory       Saved in ~/.claude/CLAUDE.md

  27 memories in ./CLAUDE.md

→ 수정하고 싶은 파일을 선택하여 메모리를 관리

프로젝트 메모리 (./CLAUDE.md):
  • 이 프로젝트에서만 적용되는 규칙/설정
  • 예: "이 프로젝트는 Python 3.11 사용, 한글 주석 필수"

사용자 메모리 (~/.claude/CLAUDE.md):
  • 모든 프로젝트에 공통 적용되는 규칙/설정
  • 예: "항상 한글로 응답, 코드 주석은 한글"

핵심 체크포인트

• ✅ CLAUDE.md는 settings.json과 유사한 역할의 메모리 파일
• ✅ 프로젝트 단위(./CLAUDE.md)와 사용자 단위(~/.claude/CLAUDE.md)로 분리
• ✅ /memory 명령어로 간편하게 메모리 편집 가능

섹션 6: MCP 관리, /mcp

한 줄 요약

/mcp는 외부 서비스(MCP 서버)를 클로드 코드에 연동하여 추가 도구와 명령어를 사용할 수 있게 하는 명령어다.

쉬운 설명 (스마트폰 앱스토어 비유)

"스마트폰에 앱을 설치하면 새로운 기능이 추가되는 것처럼, /mcp로 외부 MCP 서버를 연결하면 클로드 코드에 새로운 도구가 추가된다. 예를 들어 토스페이먼츠 결제 API 문서를 바로 조회할 수 있다."

실무 예제: MCP 서버 확인하기

> /mcp

Manage MCP servers

1. tosspayments-integration-guide  ✔ connected

→ 상세 정보:
  Status: ✔ connected
  Command: npx
  Args: -y @tosspayments/integration-guide-mcp@latest
  Capabilities: tools
  Tools: 3 tools

→ View tools:
  1. get-v2-documents     ← v2 API 문서 조회
  2. get-v1-documents     ← v1 API 문서 조회
  3. document-by-id       ← ID로 문서 조회

핵심 체크포인트

• ✅ /mcp로 연결된 MCP 서버를 조회하고 관리
• ✅ MCP 서버가 제공하는 도구(tools)를 바로 실행 가능
• ✅ 외부 API 문서를 클로드 코드 안에서 바로 참조 가능

연습문제 풀이

Q1: /model에서 Default 옵션을 선택했을 때, $100 플랜 사용자가 사용 제한의 20%를 넘으면 어떤 일이 발생하는가?

A: 자동으로 Opus 모델에서 Sonnet 모델로 전환된다. Default 옵션은 비용 최적화를 위해 사용량에 따라 모델을 자동 전환하는 기능이다. $200 플랜은 50% 기준으로 전환된다.

Q2: Auto Compact 대신 수동 /compact를 추천하는 이유는?

A: Auto Compact는 작업 도중에 의도치 않게 실행될 수 있어 콘텍스트 요약이 어색해질 수 있다. 마치 책의 1장을 요약하지 않고 1.5장을 요약하는 것과 같은 상황이 발생한다. 작업 전환점에서 직접 /compact를 실행하면 더 자연스러운 요약이 가능하다.

Q3: /permissions에서 프로젝트 단위 권한과 사용자 단위 권한은 각각 어디에 저장되는가?

A: 프로젝트 단위 권한은 .claude/settings.local.json에 저장되고, 사용자 단위 권한은 ~/.claude/settings.json에 저장된다. 프로젝트 단위는 해당 프로젝트에서만, 사용자 단위는 같은 사용자의 모든 프로젝트에 적용된다.

Q4: CLAUDE.md 파일의 두 가지 종류와 각각의 역할은?

A: (1) ./CLAUDE.md (프로젝트 메모리) — 해당 프로젝트에서만 적용되는 규칙과 설정을 저장한다. (2) ~/.claude/CLAUDE.md (사용자 메모리) — 모든 프로젝트에 공통으로 적용되는 전역 규칙을 저장한다.

부록 A: 용어 사전

부록 B: 핵심 비교표

슬래시 명령어 한눈에 비교

권한 저장 위치 비교

모델 선택 비교

부록 C: 추천 참고 자료 & 링크